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DESCRIPTION 


The DECtape Editor provides a means of creating, adding to, or deleting from sequentially numbered lines 
in DECtape files. The lines may be statements within a MACRO-6 or FORTRAN program, or numbered 
lines of data for any purpose. 

OPERATING INFORMATION 

The DECtape Editor is brought from the system tape, stored in memory, and initialized by the following 
control statements, typed on the teletypewriter: 

IJOB 
CORE 1 

GET SYS:EDITOR 
START 

where the number 1 represents the core memory space required by the 1,000-word program. (If insufficient 
core space is available, a diagnostic message will be printed.) 

COMMANDS 

The Editor enables the user to select a DECtape unit and to modify the directory, which contains a list of 
all files present on the tape. By means of commands to the Editor the directory may be examined and 
:leared, a new file may be added to the directory, or a file currently in the directory may be selected. 
When a file has been selected, the user may resequence the file, print one or several lines, or delete or 
3 1 ter existing lines with input commands. Table 1 is a listing and description of available Editor commands. 
After each command is executed, the Editor types the symbol * . 


TABLE 1 EDITOR COMMANDS 


Command 

Effect 

SX <CONTROL A> <CR> 

Selects unit X and clears the directory. 

SX,NAME <CONTROL A> 
<ALTMODE> 

Same as above, but creates file name after clearing. 

SX,NAME <CR> 

Allows the user to access file name on unit X. If no such file 
exists, the error message *NCF* will be printed. 

SX,NAME <ALTMODE> 

Creates a new file called name on unit X. If name already 
exists, the error message *FAU* will be printed. 



TABLE 1 EDITOR COMMANDS (continued) 



Insert at line Nl, where N1 may be a sequence number or the 
special character - (Point). The • character has the value of 
the last line number typed. If Nl is an existing line, it is 
replaced. 


INI ,N2 <CR> 
DN1 <CR> 
DN1 , N2 <CR> 
PN1 <CR> 

PN1 ,N2 <CR> 


Insert at line Nl, and set the indexing increment to N2. 
Delete line Nl . 

Delete lines Nl through N2. 

Print line Nl . 

Print lines Nl through N2. 

Operating Modes 


Th. Editor operates in one of two modes: oommond or text. The Edits, is initialed in the command mod, 
wherein it responds to oser instructions. The text mode is selected with the insert command (see Table 1), 
and enables the use, to enter new lines, or to alter existing lines. Return from the text mode to the com- 

mand mode is effected by typing <ALTMODE>. 


Example of Usa ge 

Suppose that a file of sequentially numbered lines of text is to be stored on DECtape unit number 1 . After 
requesting that the program assign the desired tape and initializing the editor, we would type 

*S1, TEXT 


followed by the <ALTMODE> command to select the assigned unit, and create a new file named TEXT 
The * is typed by the editor. 


The insertion command might then be typed, followed by a carriate-return . The program would respond 

by typing the selected number for the first line, and would then enable the text mode. One complete 
file would look like this: 

*110 <CR> 

00010 THIS IS A SAMPLE LINE OF TEXT <CR> 

00020 THIS IS A SECOND SAMPLE LINE <CR> 

00030 THIS IS A THIRD SAMPLE LINE <CR> 

00040 <ALTMODE> 

*E <CR> 
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To alter this file, we type 
*S1, TEXT 

followed by a carriage return. We may then delete line 10 and alter line 20 as follows: 

*D10 <CR> 

*120 <CR> 

00020 ALTERED LINE <CR> 

*ILR* 


The *ILR* does not indicate an error but indicates that the normal sequence would create an improper 
line number . 


To check the contents of the updated file, we may type 

*P10, 40 <CR> 

causing the program to respond by typing 


00010 

00020 ALTERED LINE 

00030 THIS IS A THIRD SAMPLE LINE 


Line Insertion Procedure 

To insert a line of text, type the insert command. The sequence number of the line being referenced will 
be printed, followed by a tab. Type in the line being inserted, followed by a <CR>. (The line may con- 
tain any character except RUBOUT or ALTMODE.) The Editor will now add the indexing increment to the 
line number and print the incremented line number, followed by a tab. (The indexing increment is initially 
set to 10; if any other increment is desired, use the appropriate insert instruction from Table 1 .) The 
Editor is ready to accept the next insertion. 


Errors 

To correct a typing error, type rubout to delete the unwanted character; the Editor will respond by typing 
a\ . Successive characters may be deleted by typing more rubouts, until the beginning of the line has 
been reached, at which point the Editor will cease responding with\ , and answer with a <CR>. Table 2 
is a listing and description of Editor error messages. 
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TABLE 2 EDITOR ERROR MESSAGES 


Significance 


*ILC* 


*NLN* 


*UNA* 


*DCE* 


*NFO* 


*FAU* 


*NCF* 


Illegal command 

A P or D has made reference to a nonexistent line. 

The index step (in insert) has caused a line already in the file to be 
skipped . 

The index step has caused an already existent line to be referenced 
by insert. 

A DECtape unit has been selected that is not available to the user. 
No more room on the DECtape directory file. 

A command has been invoked that requires an active file, but no file 
has been selected (by S) . 

File name already in use. 

Not a current fi le . 


* DDF* 


Device data error . 
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